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This article introduces the next version ol MathPSfrag. MathPSfrag is a Mathematica" package 
that during export automatically replaces all expressions in a plot by corresponding MJ^X com- 
mands. The new version can also produce I^Tp^X independent images; e.g., PDF files for inclusion 
in pdfM^njX. Moreover from these files a preview is generated and shown within Mathematica. 
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Introduction 

Many programs producing EPS graphics do not allow 
the inclusion of I^T[?;X commands. While there exist sev- 
eral solutions to work around these difficulties, they all 
have various drawbacks. (See [1 for a discussion of sev- 
eral methods and an alternative approach to overcome 
these difficulties.) In this article, we will focus on a par- 
ticular existing solution, the PSfrag package [2J, which 
provides MrgX macros allowing the user to replace pieces 
of text ( "tags" ) in an EPS file by an arbitrary I^T[t;X con- 
struct. 

However, for PSfrag to work, the application must 
write tags unaltered into the EPS file. For Mathe- 
matica [3,4, this requirement amounts to using sin- 
gle words, strictly consisting of alphanumeric characters 
only. As a consequence, the user has to work most of the 
time with an inconveniently labeled graphic and is fur- 
thermore required to keep track of the tags used in the 
substitution macros. 

On the other hand, it is not always possible to use 
Mathematica 's conventional export function as it pro- 
duces EPS files requiring the inclusion of additional fonts 
into the document. This means configuring the local 
T!^^ installation such that it finds the fonts provided 
by Wolfram Inc. [5, 6, 7 , a process often not being un- 
der the author's control. A way out is to include the 
fonts into the EPS file and set the font family to a stan- 
dard PostScript one. The required steps are version 
dependent — the latest version as of this writing, 6.0, has 
sane defaults — for 5.2, the following commands are re- 
quired: 
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(a) Conventional Mathematica plot before using 
MathPSfrag 
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(b)Thc same plot after automatically substituting all 
Text primitives (including tick mark labels) by WT^^ 
output. 

FIG. 1: Old vs. new graphics export mechanism. 



Plot[. . . , TextStyle^{FontFamily^"Times"}] 
Export [. . . , ConversionOptions^ 

{ " IncludeSpec ialFont s " ^True}-] 



However, automatic inclusion of Mathematica's spe- 
cial fonts, which irrespective of the chosen FontFamily 
are used for displaying important symbols like brackets, 
is only a last resort. While the slight mismatch between 
a standard PostScript font's appearance, (here Times 
Roman, cf. fig. 1(a)), and that of I^T[TpC's standard font 
(Computer Modern) may be acceptable in case of ordi- 



nary text labels, mathematical expressions like square 
roots or fractions cannot compete with MrgX's typeset- 
ting quality in this approach. 

Font inclusion is also a feature that — like the visually 
displeasing option to not use special fonts at all — has 
become available only starting from Mathematica ver- 
sion 4.2.1. Consequently, some authors simply restrict 
labeling of Mathematica plots to a bare minimum. 



* jgrosseOth.if.uj.edu.pl 
|http : / /wwwth . mppmu . mpg . de/members/jgrosse/mathpsf rag| 
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FIG. 2: Action of \psf rag{tag} [be] [bc]{\TeX}. The first coordinate pair [be] picks the reference point (red crossed circle) 
in the TjrjK expression (fig. a), the second one in the tag that is part of the original EPS file (fig. b). Positioning is achieved by 
overlaying both boxes such that their respective reference points coincide (fig. c). The final result is shown in fig. d. Scales are 
exaggerated for better illustration. 



MathPSfrag 8^ is a package that conveniently pro- 
duces publication-quality labels in EPS files generated 
by Mathematica. MathPSfrag automates many (often 
all) tedious details related to the use of the standard 
I^TgX package PSfrag, while still allowing manual fine 
tuning. As a demonstration of the degree of automation, 
compare fig. 1(a) , which has been generated by using the 
standard Mathematica command Export, and fig. l{h)j 
generated by MathPSfrag's export instruction. 

While the solution presented here, relies on the PSfrag 
package, it avoids many of its shortcomings by providing 
a semi-automatic layer. In many cases it is sufficient to 
simply use the new PSf ragExport command. 

MathPSfrag also allows the creation of stand-alone im- 
ages that do not need any additional preparations in 
the manuscript. This is achieved by calling I^T^^^X and 
Ghostscript from within Mathematica requiring the user 
to have a full I^T[t;X distribution on the same machine 
where Mathematica resides. 

The first section of this document describes the PSfrag 
package, while the second and third section explain 
its counterpart MathPSfrag. A number of small examples 
are shown followed by a discussion of how to produce 
PDF files. Before the conclusions, a few limitations of the 
current approach and its implementation are discussed. 



I. PSFRAG 

This is intended to be a short introduction to the I^T[t;X 
package PSfrag explaining only the essential features nec- 
essary to understand the corresponding Mathematica 
package's internals and to take advantage of its manual 
options if automatic placement does not yield the desired 
result. The full documentation can be found in [2 . 

PSfrag provides the macro 



\psf rag{(tag)}- [[texposition]^ [\pspositioii]2 

[[scale]] [[rot]]{{_0TfeX)} 

which replaces any occurrence of (tag) in the output of 
an EPS file by {WT^). According to [2J, "all \psfrag 
calls that precede an \includegraphics (or equivalent) 



(center line) 
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-[br][br 



-[tr][Bl]- 
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FIG. 3: Illustration of the various optional arguments of the 
\psf rag command, taken from '2 with minor changes. The 
first option determines the alignment of the ffl^TjX description, 
while the second one is responsible for the point to which the 
Ifl^jX macro is attached. 



in the same or surrounding environments" will affect 
the output of the included graphics; i.e., \psf rag com- 
mands can be defined either locally, to act on strictly 
one graphic, or globally, thus acting on all graphics in a 
document. The mechanism is demonstrated in fig. 2 

[texposition] and [psposition] are optional argu- 
ments that allow setting (first) the vertical (top, bottom, 
Baseline, or center) and (second) the horizontal (left, 
right, center) alignment of the replacement text by speci- 
fying the respective first character of the choices given in 
parentheses. The arguments refer to the position of the 
reference point in the respective bounding boxes. The 
I^T[t;X construct is placed such that its reference point is 
at the position of the corresponding PostScript (tag) 
box' reference point, cf. fig. 3, 

[scale] and [rot] permit scaling and rotation of the 
inserted box, where the rotation (in degree) is relative to 
the slope of the PostScript bounding box such that a 
value of "0" preserves the orientation, see fig. 7 Scaling 
is best achieved by using I^T^^X scaling commands, like 
\Large, instead of the [scale] option, since the standard 
I^TgX fonts consists of bitmaps rendered specifically for 
the chosen size and do not rescale well. 

Since PSfrag exchanges the labels of an EPS image, 
these may protrude from the bounding box of the re- 
sulting image. Fortunately, \includegraphics offers the 
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options bb and trim, which may be used to override or 
correct the obsoleted information in the EPS file. In par- 
ticular, in conjunction with some of the PDF production 
techniques described in subsequent sections, correct (ed) 
bounding boxes can be important because protruding 
material might be clipped. 



II. MATHPSFRAG 

There are only three commands needed to control 
MathPSfrag's EPS generation: PSf ragExport, which 
supersedes Mathematica's Export command, and 
PSf rag, which allows overriding of the defaults for par- 
ticular expressions. In addition the UnPSf rag command 
is provided which calls I^T[t;X and Ghostscript to carry 
out the PSfrag replacements and create an (ordinary) 
EPS and PDF image that can be included with the usual 
\includegraphics command. 

The export function is usually called in conjunction 
with UnPSf rag: 



PSfragExport [(basename) , 
II UnPSf rag; 



(graphics), [options]] 



This converts (graphics) , the usual Graphics construct 
returned by Mathematica commands like Plot, to an 
EPS file and a I^T[t;X file containing \psf rag macros. The 
UnPSfrag command, if provided, will merge these two 
into a single EPS file and will also produce a PDF version. 
More about this in section III 

There are a number of options for PSfragExport that 
can be used to override internal assumptions about the 
automatic processing of graphics. They are documented 
in the manual accompanying MathPSfrag. The respective 
file names of the and EPS file are determined by 

(basename) to which the value of the options TeXSuf f ix 
and EpsSuff ix is appended. 



• TeXSuf fix^" (string) 

• EpsSuff ix^" (string) 



("-psfrag.tex") 
("-psfrag.eps") 



Unless a base name containing a path is given, the output 
is written to the current directory, which can be set using 
Mathematica's SetDirectory. Unknown options are 
passed on to the graphics using a Show command. 

It may happen that the user is not satisfied with the 
automatic output generated by PSfragExport. There- 
fore it is possible to manually control the replacement of 
any expression by wrapping 

PSf rag [(expr) , [options]] 

directly around any Mathematica expression (expr) 
appearing as text in a graphic, such as the argument 
of a PlotLabel^ ... or AxesLabel— > . . . option or a 
Text graphics directive. As a simple example, consider 



p=Plot[. . . ,PlotLabel^PSfrag["x"2-test" , 

TeXCommand^"$\\chi~2$-test"]] ; 
PSfragExport ["chisquare" , p] ; 



This is also the simplest possibility to correct malformed 
automatically generated I^T[t;X code. 

PSfrag processes the following options, whose defaults 
have been put in parentheses. 



• TeXCommand—!-" (string)" 

• PSfragTag^" (string)" 

• TeXPosition^"(yx)" 

• PSPosition^"(yx)" 

• PSRotation— !-(number) 

• PSScaling^(number) 

. TeXShiftX^"(texdim)" 



(Automat 



ic 



. TeXShiftY- 



(texdim) 



(Automatic) 
(Automatic) 
(CopyTeXPosition) 
(0) 

(1) 

(Opt) 

(Opt) 



Actually, PSf ragExport 's automatic mechanism basi- 
cally wraps PSfrag around all Text primitives using the 
default values above. However, manual wrapping has the 
advantage of allowing different options to be apphed to 
expressions where the automatic behavior did not give 
satisfactory results. 

TeXCommand^" (string)" uses (string) as the BTJ^X 
command to appear in the final EPS graphic as a re- 
placement of the corresponding expression (expr). If 
set to Automatic, the internal function GuessTeX is 
called, which is essentially a wrapper for TeXForm that 
adds $ signs around math expressions. The options 
PSf ragTag, TeXPosition, PSPosition, PSRotation and 
PSScaling arc in one-to-one correspondence to the op- 
tions of \psf rag explained in the previous section. 

As a last resort TeXShif tX/Y provide a way to move 
the I^TgX expression by a specified T]^^ dimension. A 
disadvantage of this method is that it docs not scale with 
the image dimensions. 

Unless the user provides specific values, MathPSfrag 
uses the FullGraphics command to determine the argu- 
ments for TeXPosition and PSPosition. 

Unfortunately FullGraphics does not work for three- 
dimensional graphics, such that PSfragExport falls back 
to PSf ragManualExport, which does not perform any 
alignment detection and can also be used for two- 
dimensional graphics if automatic processing is not de- 
sired. In these cases PSfrag has to be applied by hand to 
the argument of any Text directive and text producing 
option like PlotLabel. Moreover at least the values of 
TeXPosition will have to be given by the user. 

Since this can be rather cumbersome for explicit tick 
mark specifications, an additional convenience command 
has been introduced, 
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code of all example plots shown in this article also con- 
tains a comprehensive step-by-step guide of how to set 
up these paths permanently. Detailed explanations can 
also be found in the manual. 
The syntax of UnPSf rag is 



0.5 













/ ^ 

/ 0.5 


1 ^^^---^^^ 



/ -0.5 
1.0 



-0.5 



Ticks^{ 

PSfragTicks [LinTicks [-1,1] ,TeXPosition^"Bc"] , 
PSfragTicks [LinTicks [-1,1] ,TeXPosition^"Bl"] , 
PSfragTicks [LinTicks [-1,1] ,TeXPosition^"Br"] > 



FIG. 4: Three dimensional example: As there exists no 
FullGraphicsSD command, manual labeling was preformed 
by using the above PlotSD option. LinTicks is provided by 
the CustomTicks package [9 . 



PSfragTicks [(tickspec) , [options]] 



which simply applies PSf rag with the provided [options] 
to any tick mark label in (tickspec) . Since the tick mark 
specification itself is usually quite lengthy, it is recom- 
mended to create it with the LinTicks [(from) , (to)] 
command from CustomTicks [9,. A three-dimensional 
plot illustrating this procedure is included as example 
code; its output is depicted in fig. [4] 

III. UNPSFRAG 

With the commands described so far, standard PSfrag 
EPS pictures can be produced. Math PSfrag provides two 
additional features that require a full f^TgX run from 
within Mathematica. First, creation of pre-rendered 
EPS images, which do not require the PSfrag package 
anymore. Such pre-rendered images will be called "unps- 
fraged" henceforth. Second, conversion to PDF images 
suitable for pdA^T^X or raster images providing a pre- 
view of the final plot. For both features. Math PSfrag 
needs to know where to find the executables for I^T[t;X, 
dvips and Ghostscript. Unless the binaries arc in the 
system's execution path (as will be the case for Unix-like 
operating systems) , this requires the user to set the loca- 
tion of the files explicitly. The notebook containing the 



UnPSfrag[{(basename) , (epsfile) , (texfile)}, [options]] ; 



where {basename) is used to create the names of output 
files by appending suitable suffices like " .pdf " or " . eps" . 
The other two mandatory parameters should point to 
the tagged EPS and PSfrag-I^TEX files that are to be 
merged. PSfragExport returns the three file names in 
exactly this format such that its output can be directly 
fed to UnPSf rag. 

UnPSf rag has a number of additional options that con- 
trol how images are created. Again only the most impor- 
tant ones shall be given here, while a complete list is 
given in the manual. 

By default, UnPSf rag only produces an EPS and a PDF 
file, though it should be possible to generate other output 
formats by setting the UnPSf ragOutputFormats option 
accordingly. 

Furthermore UnPSf rag shows a low resolution bitmap 
preview of the final images. While this is extremely 
useful for checking if MathPSfrag has produced the de- 
sired results, it will enlarge the notebook considerably, 
which can be inconvenient for email exchange. Setting 
the PreviewDevice option to None will switch off this 
behavior. This option is further discussed in the section 
on known bugs. 

When using the PSfrag option TeXCommand to spec- 
ify I^T[TpC code, it might require additional style files. 
These can be included by UnPSf rag when providing the 
appropriate \usepackage command as a string via the 
TeXPreamible option. 

IncludeGraphicsDptions is the most important op- 
tion. The string it provides is handed over to the 
\includegraphics command in the I^T[t;X file used to 
perform the \psfrag replacements. The option can 
therefore be used to set the size of the rendered graphics; 
e.g., by setting its value to "width=7cm". Note however 
that the final bounding box will correctly fit the image 
content instead of exactly matching the specified size. 
This mismatch is due to the bounding box changing dur- 
ing PSfrag's replacement procedure. When an exact size 
is required, it can be reapplied in the manuscript, though 
it is better to adjust the size from within Mathematica, 
the reason for which is explained in the next section. 



IV. IN THE MANUSCRIPT 

UnPSfrag'ed images do not require any additional 
treatment or package beyond graphics/graphicx. Since 
EPS and PDF versions are created anyway, it is recom- 
mended not to provide any suffix for the file name in the 
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FIG. 5: Example plot without resorting to automatics; i.e., 
exported with PSf ragManualExport. Additionally, the type- 
setting of the "cos ..." label has been manually improved. 



sin(25a;^-6) 
sin(5x) + 2 




0.5 1.0 1.5 2.0 2.5 3.0 



FIG. 6: HoldForm example: Without HoldForm, Mathemat- 
ICA would normal order the label on the w axis to — ■ 
The CustomTicks package has been used to avoid the typical 
stripped decimal "1." on the x axis. 



\includegraphics command, such that the manuscript 
translates with both I^Tp^X and pdfT^T[TpC. It is possi- 
ble to issue the common size options, but this will also 
change the labels, such that they will not have the fixed 
T^^jX sizes anymore. This can potentially reduce the 
fonts quality, in particular when T^r^X's old bitmapped 
computer modern fonts are used. The UnPSf rag option 
Dvips Opt ions is by default set to "-Ppdf ", which makes 
dvips replace bitmap fonts by outline fonts on most sys- 
tems, thus reducing the problem to a mere mismatch 
between the label's size and that of the manuscript's 
text. In any case it is advisable to adjust the plot size 
from within Mathematica before rendering by applying 
IncludeGraphicsOptions to UnPSfrag, since rescaling 
at a later stage would also affect the labels. 

It is also possible to follow a "pure" PSfrag approach, 
where all replacements are performed on the level of the 
manuscript. This is discussed in section I Before, a num- 
ber of usage examples shall be given. 



V. EXAMPLES 

We start to consider in more detail figures 1(a) and 
[1(b) , The first one has been generated using standard 
Mathematica commands only, for the latter, the ex- 
port was carried out with PSf ragExport ["example" , 
exampleplot] //UnPSfrag. 

In fig. 5 the introductory example fig. 1(b) was recon- 
structed without resorting to the automatic positioning 
feature by using PSfrag and PSf ragManualExport only. 
Additionally, one of the labels' I^T[t;X code was improved 
to be 3 I cos \/ix\ ^ instead of 3 y/(x^^(%/x) . 

Fig. 6 demonstrates compatibility with the Cus- 
tomTicks package [9 , which can be used to customize 
tick marks, and the HoldForm command, which can be 
used to circumvent Mathematica's automatic reorder- 
ing of expressions into a normal form. 

While early Linux versions of Mathematica do 
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FIG. 7: Example for substituting rotated text. To demon- 
strate that the new export function can preserve the orienta- 
tion, only half of the labels have been substituted by I^T^jX. 



not reliably rotate text in an interactive session, 
PSf ragExport has no problems in doing so, as has been 
shown in fig. 7 Note that for each piece of text, 
the PSRotation option is left unchanged (corresponding 
to "0"), thus preserving the original orientation of the 
PostScript text. 

Finally, it has been demonstrated in fig. 4, that three 
dimensional graphics can be processed also, even though 
it has to be done manually with PSfrag commands, since 
the FullGraphics command, which is used to extract 
positioning information, only works on two dimensional 
graphics. 



VI. PDF 

For publication of I^TfTpC documents, the author often 
not only has to provide the final manuscript but also the 
sources to produce them subject to constraints set by the 
publisher. 

Therefore, Math PSfrag essentially offers two levels of 
image production, a rather sophisticated "UnPSfrag" ap- 
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proach, which aims at producing pre-rendered stand- 
alone images as has been described above, and a classical, 
PSfrag centric approach. In this approach, MathPSfrag 
is used to produce a tagged EPS file plus a PSfrag trans- 
lation file, which can convert the tags back into readable 
labels during the I^T[t;X run of the manuscript. These 
two files are generated by PSf ragExport. (Further use 
of UnPSf rag would join this pair into stand-alone graph- 
ics.) 

The decision which approach to use has an impact on 
both the process of image creation and on how to in- 
clude the images and compile the manuscript. In partic- 
ular, the PSfrag centric approach is less convenient and 
not as compatible as the UnPSfrag approach, since it 
relies on PostScript. However it has the advantage 
of producing considerably smaller images of potentially 
better typesetting quality as the used fonts are guaran- 
teed to match those of the document. Furthermore, the 
font size of labels is fixed in this approach, which is of 
particular importance for the bitmapped Computer Mod- 
ern, though modern Tf^X distributions have outline fonts 
available, which scale more gracefully. Still visual consis- 
tency might suffer from differently scaled labels. 

For inclusion of EPS images into pdfl^Tg^X manu- 
scripts, a number of packages exist, mainly due to the 
widespread use of the equally PostScript dependent 
pstricks package. Here, only the pst-pdf package will 
be described, because it is compatible with beamer's over- 
lay techniques. An example presentation using \psf rag 
to change labels in a plot slide by slide is included in 
the distribution as well as examples for the other pack- 
ages, ps4pdf and pdf tricks, that could also be used to 
achieve pdfl^TfTpC compatibility.^ 

A. Standard PSfrag ("PostScript only") 

The standard PSfrag way is to include the EPS and 
PSfrag file in a manner similar to the following code. 



\begin{psf rags} 

\input-[exainple-psf rag . tex} 

\includegraphics-[example-psf rag . eps} 
\end{psf rags} 



The {psf rags} starts an empty group provided by PS- 
frag, whose sole purpose is making \psfrag definitions 
local to the following graphic. 

The produced DVI file is then required to be converted 
to PostScript using dvips; and PDF can only be cre- 
ated by distilling from the PostScript version using for 
example Acrobat or Ghostscript(ps2pdf ). Note that the 
popular dvipdf command(s) will not work. 



The disadvantage of the pure PostScript approach 
is that the advanced typesetting features of pdff^TgX are 
not available. 

B. pdAMfcX (pst-pdf) 

pst-pdf extracts all images of a manuscript in an addi- 
tional I^T[t;X run with the help of the preview package.^ 
These can then be turned into a PostScript file and 
distilled to a PDF called image container. During the 
pdfl^Tf^X run, PDF replacements for PostScript parts 
are read from the image container. Whenever content or 
order of the images are changed in the manuscript, the 
image container must be regenerated. 

The required steps are automated in a script accom- 
panying pst-pdf. Unfortunately, the predecessor package 
ps4pdf, which is still installed on many systems, has a 
similar script sharing the same name, ps4pdf . It is im- 
portant to ensure that the correct version of the ps4pdf 
script is used that refers to pst-pdf. 

There is one additional catch due to the way \psf rag 
invalidates bounding boxes: pst-pdf must be loaded with 
the notightpage option and the ps4pdf script must be 
called with the — crop option. 

Assuming manuscript .tex to be the main document, 
either of the following instructions produces the image 
container: 



ps4pdf — crop manuscript.tex 

or 

latex mEaiuscript.tex 

dvips -Ppdf -o manuscript-crop.ps manuscript 
ps2pdf -dAutoRotatePages=/None manuscript-crop.ps \ 

manuscript-crop . pdf 
pdfcrop manuscript-crop. pdf manuscript-pics.pdf 



Of course, a distiller different from ps2pdf may be 
used. Subsequently, the manuscript can be processed by 
pdfl^TgX in the usual manner, which will use the pre- 
generated pictures stored in the -pics. pdf file. 

When uploading the manuscript to a preprint server 
that renames the main manuscript file, care has to be 
taken to explicitely specify the name of the image con- 
tainer as it will not be found by pst-pdf otherwise. This 
can be achieved as is illustrated in the following example. 



\usepackage{pst-pdf } 

\renewcommand{PDFcontainer}{manuscript-pics .pdf} 



The main advantage of this approach is that all im- 
ages are collected in one single file, which can be very 



^ A related package is auto-pst-pdf 10 , which automatizes all of 
^ I would like to thank Ross Moore for bringing these packages to the following steps provided that pdfLM?EX can be called with 

my attention. the -shell-escape option. 
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convenient for distribution, since it is much smaller than 
individual PDF versions of each image. This observation 
suggests that the collective image file is free of double 
copies of resources like fonts. 

VII. KNOWN BUGS AND LIMITATIONS 

MathPSfrag rehes on three Mathematica commands: 
TeXForm, FullGraphics and AbsoluteOptions. All are 

potential sources of failure and their respective peculiar- 
ities are highly version dependent. A detailed analysis 
of potential traps is given in the manual. Here we shall 
concentrate on how to overcome certain restrictions or 
problems. 

For versions 4.0-5.0 TeXForm produces Mathemat- 
iCA-specific I^T^?;X code that requires a compatibility 
layer or the style files and fonts provided by Wolfram Inc. 
This is explained in more detail in the appendix. Later 
Mathematica versions produce cunsmath symbols and 
code, but the results will only be satisfactory for those 
Mathematica symbols that have a direct counterpart 
in Wr^. For most applications this should of course 
suffice. 

TeXForm generates a number format that corresponds 
to InputForm, while in plots TraditionalForm would 
be appropriate. It is strongly recommended to use the 
CustomTicks package whenever numbers on the axes are 
formatted unsatisfactorily. A simple Ticks— s-LinTicks 
provide as option to the Plot command suffices in most 
cases. 

AbsoluteOptions is not always faithful in the sense 
that Show[myplot, AbsoluteOptions [myplot] ] will 
not always generate the same plot. Most of the time, 
tick marks are affected. Again, this can be avoided by 
employing CustomTicks. 

For three-dimensional plots, where manual alignment 
information has to be provided, the PSfragTicks com- 
mand should be used for convenience. 

If the MJ^X run performed by UnPSfrag fails, error 
logs are stored in internal variables and a help message 
will give hints of how to identify the error. Most of the 
time either a package is missing or a malformed I^T[t;X 
expression has been assigned to a label. The former 
can be solved by calling UnPSfrag with TeXPreemible^ 
"\\usepackage{(missiiig)}" and providing the missing 
package(s). The latter can be addressed by wrapping 
a PSf rag command about the offending Mathematica 
expression and assign better I^TfTpC code by hand using 
the TeXCommand option. 

Since \psf rag-based images will in general have incor- 
rect bounding boxes, MathPSfrag measures the bounding 
box by converting the image to a bitmap and count- 
ing non-empty lines. This should be more reliable 
than Ghostscript's bbox device, which is known to some- 
times produces incorrect bounding boxes. For speed and 



lower memory consumption, it is however possible to 
choose the bbox device by setting the UnPSfrag option 
BoundingBoxDevice— >{" .bbox" , "bbox" , " "}. 

In Mathematica version 4. 1 under MacOS X (though 
other versions before 5.2 may be affected), displaying of 
bitmap images leads to a kernel freeze on subsequent 
usage of UnPSfrag. This can be avoided by setting 
PreviewDevice^None to switch off generation of pre- 
view images. 



VIII. CONCLUSION 

MathPSfrag provides a convenient interface to PS- 
frag permitting the generation of high-quality labels in 
Mathematica graphics. While it automatizes all te- 
dious aspects of PSfrag, it still allows seamless overrid- 
ing of all of its internal assumptions. The possibility to 
create images that do not depend on PSfrag anymore pro- 
vides a simple method to achieve pdfI^T[5]X compatibility. 
For convenience, a preview feature has been introduced, 
which allows the user to easily ensure that the gener- 
ated labels are both syntactically correct and yield the 
intended output. 

Finally, MathPSfrag does not provide methods to con- 
struct correct tick mark contents as it is strictly focused 
on shape. As shown in fig. 6, it does however integrate 
well with the CustomTicks package [9J, which provides 
that functionality. 

For the future it would be interesting to incorporate 
the PSfragx extension that allows including the \psf rag 
commands into the comment section of the EPS file. It 
would be certainly desirable to export the position infor- 
mation, which is already extracted anyway, in the form of 
\overpic commands. In this context, the eps2pgf [11 , 
which can convert EPS files in conjunction with PSfrag 
labels into pure T^X/PGE code, is also of great interest 
as it could be easily modified to produce such \overpic 
commands. This approach could allow circumvention of 
some of the bounding box related difficulties arising from 
the PSfrag approach and also achieve pdfI^T[T;X compat- 
ibility on a very fundamental level. Another possibility 
would be a package that renders all graphics into the cor- 
rect size by calling I^TgX from within pdfI^Tpi]X by means 
of the -shell-escape option. 
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PROGRAM SUMMARY 



Manuscript Title: 

Authors: 

Program Title: 

Journal Reference: 

Catalogue identifier: 

Program available from: 

Licensing provisions: 

Programming language: 

Computer: 

Operating systems: 

RAM used during test run: 

Keywords: 

PACS: 

Classification: 
External routines: 
Nature of problem: 
Solution method: 
Requirements: 
Restrictions: 



MathPSfrag: Creating publication-quality Labels for Mathematica* Plots 

Johannes GroBe 

MathPSfrag 



Running time: 



http : //wwwth . mppmu . mpg . de/members/ jgrosse/mathpsf rag 
CPC non-profit use license 
Mathematica 6.0, 5.2, 5.0, 4.1 
Tested on x86 architecture 
Tested on Linux, Windows XP, MacOS X 
11 Mb 

Encapsulated PostScript, Mathematica, PSfrag, 

01.30.Rr 

14 Graphics 

CustomTicks package [9 (recommended) 

Insufficient typesetting quality of labels in graphics exported from Mathematica 

An automatic export function is provided that generates I^T[t;X substitution labels. 

Wr^, Ghostscript, PSfrag; recommended: ps2eps, Perl, pdf crop, I^T[t;X package pst-pdf 

The described method requires to some extent the use of Encapsulated PostScript (EPS) 
graphics though conversion to PDF is supported. Special Mathematica characters that 
do not have a direct counterpart in will not show satisfactory typesetting quality. 

For Mathematica versions earlier than 5.1, the automatically created I^T[TpC code re- 
quires a compatibility I^T[t;X package, which is included in the package. In Mathe- 
matica 4.1, one of the examples does not work in its current form due to a bug in 
Mathematica 's Export command. However, the same effect can be achieved using 
exclusively MathPSfrag's rotation mechanism. Moreover, in Mathematica 4.1 under 
MacOS X, display of preview images does not work. 

1 minute for all examples in this article 



APPENDIX A: MATHEMATICA 4.X-5.0 



MathPSfrag creates the I^T[t;X code that corresponds to a particular Mathematica expression by calling TeXForm. 
Starting from version 5.1 the TeXForm output is self-supporting code, which only requires a few standard packages, in 
particular amsmath. Pre-5.1 TeXForm output will require an additional style file providing Mathematica fonts that 
have to be configured accordingly [5,6,7. In the new approach, since a large number of Mathematica symbols 
do not have counterparts in standard packages, some symbols are created by gluing together existing symbols. 

When applied carefully, this method can achieve acceptable results though the current implementation is not optimal 
yet. 

The problem with the pre-5.1 output in conjunction with the PSfrag method is that it requires the Mathematica 
fonts to be available in the publisher's I^T[t;X installation, while in general they will — if at all — only be available to the 
author. (This should not be a problem when the author decides to follow the UnPSf rag approach, where all required 
fonts are embedded into the image files. It is then however necessary to include the style files by setting the according 
UnPSfrag option: TeXPreamble— !-"\usepackage{ . . .}".) 

To avoid these problems in the PSfrag approach requires a compatibility package (mma4tex.tex) that is included in 
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the MathPSfrag distribution. Basically it parses Mathematica 4.x~5.0 I^T[t;X code and replaces it by code similar to 
the output of version 5.1/5.2. When MathPSfrag detects Mathematica 5.0 or earlier, PSfragExport automatically 
creates PSfrag files that attempt to load mma4tex.tex and issue a warning when unsuccessful. There is also a 
corresponding style file mina4tex . sty that additionally loads the required font packages and ensures that iimia4tex . tex 
is only loaded once. It is recommended to include it in the preamble. Therefore both files have to be installed 
where M5;]X can find them; e.g., in a directory tex/latex/mma4tex/ relative to the texmf directory of the I^T[t;X 
distribution. Thereafter the file database ("Is-R") has to be updated. Again the details depend on the distribution. 
Typical names of the update command are mktexlsr or texhash. For MiKTeX there is the choice between the 
command line program (initexmf -u) and a graphical configuration program ("MiKTeX Options" or "Settings"; 
press the button "General/File Name Database/Refresh Now"). 
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